APPENDIX 2 


RS-232-C PORT ERROR CONDITIONS, CAUSES AND CORRECTIONS 


This section cont^ins descriptions of the errors you might encounter 
while using the B50 Interface Moduls. Mang of these errors also occur 
u/ith other ATARI peripherals; theg are listed here so you can see what 
theg mean when using the Interface Module. 

There are a number of NEW errors which gou can get from the Interface 
Module which no other peripheral produce. These new error codes are 
und er 1 ine d. 


"ERROR" 1 — Success. This is the status which successful completion 
of an I/O Operation produces. BASIC does not report this to 
gou except bg continuing in normal fashion. 

ERROR 128 — Break abort. This means gou pressed the BREAK keg while 
I/O was proceeding. 

ERROR 129 — IOCE alreadg OPEN. Your choice of channel number (#n) 
was that of a channel (IDCB> which was alreadg OPEN. This 
can happen if gou restart a program in a manner other than 
RUN (RUN closes files). Be careful not to put gour OPEN 
statement inside a progranuned loop. The second time OPEN is 
encountered it will produce ERROR 129, 

ERROR 130 — Nonexistent device. You specified something other than 
R: i RI: , R2: , R3: , or R4: . Perhaps gou were trying to 

access a file on disk whose name starts with "R" and forgot 
the D: . THIS ERROR WILL OCCUR IF YOU ATTEMPT TO USE AN 
RS-232-C PORT AND THE RS232 HÄNDLER HAS NOT BEEN "BGOTED 1 ’ 
WHEN THE SYSTEM WAS TURNED ON, In that case, you should 
save your program and start a new session, allowing the 
RS~232—C handler to boot. See the section on automatic 
bootstrap. 

ERROR 131 — Write only. You tried to read (GET, INPUT) from a port 
you QPENed as write only, 

ERROR 132 — Invalid command. You specified something incorrectly in 
an XIO command to the Interface Module. 

ERROR 133 — Channel not OPEN. You neglected to OPEN the channel 
(IOCB) to the I/O device gou are trging to access. 

ERROR 135 — Read only, You tried to write (PUT, PRINT) to a port gou 
opened for read access only. 




ERROR 13B — Device t imeout. The Interface Mod u I e did not respond to 
a command. Check the cab1 es. Make sure the Interface 
hodule is powered on. 

ERROR 137 -- NAP,. The Interface Module refused to perform some 

command. You mag issue a STATUS request to find out wha t 
uias uirong. Most common causes are: attempts to perform 5-< 

6 -, or 7-bit input at too high a Saud rate; automatic 
readiness checking was enabled and the connected device was 
not ready. 

ERROR 150 — Port already OPEN. You attempted to OPEN an RS-232-C 

-— port but is was already OPEN through another channel 

(IDCB). You can access an RS-232-C port through only one 
channel at a time. 

ERROR 151 — Concurrent mode I/O not enabled. You attempted to start 

■■-— concurrent mode I/O (XIO 40) but the port was not opened 

with an odd number specified for Auxl (Auxl bit 0 not 
set). 

ERROR 152 — Illegal User-supp1ied Suffer. In the START CONCURRENT 
MODE I/O command with the user-supp1 ied buffer. the 
buffer address and/or the buffer length uere 
inconsistent. 

ERROR 153 — Active Concurrent Mode I/O Error. You attempted to 

perform I/O to an RS—232-C port while Concurrent Mode I/O 
was active to some other RS-232-C port. Only input. 
output. CL05E and STATUS commands to the active 
concurrent mode port are allowed while concurrent mode 
I/O is active. This error message is not always produced 
— attempts to do disallowed I/O while concurrent mode 
I/O is active may result in the Computer "crashing". 

ERROR 154 — Concurrent mode I/O not active, Concurrent mode I/O 

must be activated in order to perform input (GET. INPUT). 
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APPENDIX 3 


PRINTER PORT ERROR CDNDITI0N3, CAUSES AND CORRECTIONS 

This section describes error conditions which could occur when using 
the printer port. Th er e are no new error codes associated with the 
Interface Modul «'5 printer porti however, the meaning of some of the 
errors i 5 slightly different betmeen the Interface Moduls and other 
AT ARIprinters. 

If an error occurs which is not listed here» tonsult the BASIC 
reference manual. Errors are listed her« only if they have some new 
meaning when reported by the Interface Module. 

ERROR 133 — Timeout. The Interface Moduls did not respond to a 

request from the Computer. Check the cables. Make sure the 
Interface Module and attached printer are powered on. The' 
Interface Module will NOT respond to printer control 
commands from the Computer if the FAULT wire to the printer 
is low (caused by loose cable or printer off). 

ERROR 139 NAK. The Interface Module refused an illegal printer 

command. Make sure that Auxl and Aux3 are specified as lero 
(0) in y our OPEN command for the printer. This error also 
occurs when the printer appears active (FAULT line is high) 
but the printer fails to respond to characters sent to it 
mithin four seconds. Check the switches on the printer 
(online?). If the printer is not performing within 4 
seconds; change your PRINT Statements to break down 
transmissions into smaller chunks. 

NOTE: Attempts to operate more than one printer at a time will result 

in unpredictable Operation. While one printer may "win" most of the 
time» errors are always possible» and eiactly which error occurs is a 
matter of Chance. If you have more than one AT AR I printer attached to 
your Computer» turn on only one of them at a time. 
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APPENDIX 4 


MEANING DF (ERROR) BITS IN LOCATION 746 


TABLE I — Decimal Representation of the Error Bits in Location 746 


Decimal Equivalent 


Error 


128 

64 

32 

16 

8 

4 

2 

1 


Received data framing error 
Received data byte overrun error 
Received data p a r i t y error 
Received data buffer overflou error 
Illegal Option combination attempted 
External device not fully ready flag 
Error on block data transfer out 
Error on command to Interface Moduls 


3 e 1 o w are the descriptions of these error Status bits in location 
746 after STATUS c ommand. 

RECEIUED DATA FRAMING ERROR (bit 7, decimal value 128> This error bit 
indicates a framing error was encountered in the data coming from the 
external RS-232-C-compatible device: the lOth bit of some character 

was not a STOP bit (9th, 8th or 7th in the cases of 7—, 6-, or 5-bit 

received sords). This error can be caused either by garbled data 
(e, g.i noise on the phone lines) or by improper configuration to 
receive the data (s. g. , wrong Baud rate). This condition is monitored 
in one of two places: in the 400/800 Computer, or in the Interface 

Module. The Computer watches for this error in the case of 8-bit data. 
The Interface Module Catches this error-if you are receiving 7-» 6—, 
or 5~bit data. In both cases. the error status is set at the time the 
erroneous character is received (not the time you read it out of the 
Holding buffer). In the 8—bit data case. where the Computer monitors 
the error, you may find out about the error any time after it occurs 
by issuing STATUS whi1e the concurrent mode input is active. The error 
bit will be cleared when you issue the STATUS command. This error bit 
will be cleared also when you CLOSE the concurrent mode .channel. In 
the 7—i 6—i and 5-bit cases. the error is monitored by the Interface 
Module and cannot be interrogated while the concurrent mode input 
Operation is active. In this case, you must CLOSE and re-CPEN the con¬ 
current mode channel and then issue STATUS to determine if the error 
occurred. The error bit in the Interface Module is cleared by STATUS 
when concurrent mode I/O is not active) it is also cleared by most of 
the configuring and control XIO's (but not all), and Cit may be 
clearedl by CLOSE when concurrent mode I/O is not active. 


In general, the error bits read from location 746 after a STATUS 
request apply only to the most recent I/O Operation to the RS-232-C 
port) that is, they are cleared as the I/O Operation is started and 
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then set if the error occurred. Y o u can see that the previous error is 
an exception t o this rule, Üther exceptions will be noted. 

RECEIVED DATA BYTE OVERRUN ERROR (bit 6. decimal value 64) This f 

error bit is maintained by the Computer and indicates that the 
Computer g o t too b u s y to read all the data as it was arriving (due to 
overly heavy interrupt loading. or perhaps Interrupts being masked off 
totally). This error is flagged u/hen the first character of data 
following the error is read from the port and placed in the holding 
buffer. The error should not occur at all under norma1 conditions. 

RECEIVED DATA PARIT/ ERROR (bit 5. decimal value 32) This error bit is 
maintained by the Computer and indicates that a received character had 
the iiirong parity. The bit will not be set if no parity checking has 
been enabled. This error occurs during the translation from the ex- 
t er na 1 (received) form of the character to the internal (INPUT, GET) 
form. The error flag bit is cleared by the STATUS command. 

RECEIVED DATA BUFFER OVERFLOW ERROR (bit 4; decimal value 16) This 
error flag indicates that more data has arrived than can be held in 

the mput buffei data has not been read from the buffer (INPUT. GET) 

soon enough. This error is maintained by the computeri and it occurs 
When the overflowing character arrives from the RS-232-C compatible 
device. The new character replaces the oldest one in the buffer. This 
error bit is cleared by the STATUS command. 

ILLEGAL OPTION COMB INATION ATTEMPTED (bit 3. decimal value 0) This 
error flag is kept in the Interface Module and may be read by STATUS 
only if concurrent mode I/O is not active. It is set by an attempt to 
Start concurrent mode input with short uords (7-, 6-, or 5-bit) with 

the port open for both input and output (short uords are a 11 owed one 
direction at a time only) or too high a Baud rate (short uords are 
allowed for input at a maximum rate of 300 Baud). This error may be 
c hec k ed immediately after the Interface Module produces a NAK for the 
refused command. The bit is cleared by the STATUS request. Error bit 
(command error, decimal value 1) will always be set uh en this bit is 
set. 

EXTERNAL DEVICE NOT FULLY READY (bit 2, decimal value 4) This bit is 
kept in the Interface Module and may be read by STATUS only when 
concurrent mode I/O is not active. It is set whenever a START 
CONCURRENT MODE I/O or block output command is refused by the 
Interface Module because one or more of the external status lines 
being monitored is not ON. Any of the external status lines not being 
monitored (as set by the SET BAUD RATE command) is ignored. and if 
none is being monitored this bit will not be set and the I/O Operation 
will proceed normally. Read this flag bit with a STATUS request 
immediately after the Interface Module refuses the Operation with NAK. 

This flag is cleared by the STATUS command. 

DATA BLOCK ERROR (bit 1, decimal value 2) This error bit is main¬ 
tained in the Interface Module and may be read by STATUS immediately 
after a command is refused by NAK. In a block output, the data block 
was unsuccessful ly received from the Computer by the Interface Module. 
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This error should not occur in normal Operation; it indicates problems 
in communication between the Computer and Interface Module. 

COMMAND ERROR TO INTERFACE MODULE (bit 0- decimal value 1) This error 
bit is maintained in the Interface Module and may be read by STATUS 
immediately after a c ommand is refused by a NAK from the Interface 
Module, This bit indicates that the Interface Module did not recogniie 
a command sent to it from the Computer, or that the Interface Module 
is not configured properly to perform the command (see ILLEGAL OPTION 
COMBINATION ERROR). 

Düring active concurrent mode I/O, the STATUS command will return the 
number of characters in the input buffer in locations 747 and 743, and 
the number of characters in the output buffer in location 749. To find 
the number of characters in the input buffer in BASIC: 

LET BUFFERUSE = PEEK(747> + 256*P£EK(74S) 

If you want to find out only whether or not any characters are in the 
input buffer, you do not need to multiply by 256: 

IF PEEK(747)+PEEK<748)=0 THEN input buffer empty. . . 


or: 


IF PEEK(7475+PEEK(748) <> 0 THEN input buffer not empty... 

If you are using the built-in buffer, or if your supplied buffer has 
feuer than 256 bytes, then location 748 will always be iero and you 
need to look only at location 747. The output buffer holds only 32 
characters; location 749 will never exceed 32. 

When concurrent mode I/O is not active, location 747 will contain 
Information about the monitored readiness lines (DSR, CTS and CRX) and 
the data receive line (RCV) of the specified port after a STATUS 
request. Locations 748 and 749 will not contain anything useful after 
a STATUS request when there is no active concurrent I/O. 

Location 747 will contain the sum of four numbers, shown in table II. 
The current and past Status of DSR, CTS, and CRX as well as the 
current status of RCV are included. The past Status of DSR, CTS and 
CRX applies back to the time the Interface Module was booted, or to 
the most recent STATUS command to the specified port which was made 
while concurrent mode I/O was not active (i.e., the last time that 
DSR, CTS and CRX were supplied to a STATUS request). No other 
operations affect the past status of these lines. 

Ports 2 and 3 will always show CTS and CRX as being QN. Port 4 
will show CTS, CRX, and DSR as being ON. 

A quick way to check whether or not a port is ready is this: 

STATUS #n. XXX 

IF PEEK1747) < 128 THEN not ready .. 
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or to check if it has stayed ready since the last check: 

IF FEEK (747 ) >= 192 THEN always ready ... 

In other uiord?. the DER status bits are the most significant bits in 
the sense byte. and you can check them this way without having to 
ü/orry about the states of the other bits in the byte. 

TABLE II—SENSE UALUES ADDED INTO LOCATION 747 


DATA SET READY (DSR) 
192 Ready now 

128 Ready now 

64 Not ready 

0 Not ready 


(ON); on since previous STATUS 

(ON); not always on since last STATUS 

now (OFF); not always off since last STATUS 

now (OFF): always off since last STATUS 


CLEAR TO SEND (CTS) 
48 Clear now 

32 Clear now 

16 Not clear 

0 Not clear 


(ON): on since previous STATUS 
(ON); not always on since last STATUS 
now (OFF); not always off since last STATUS 
now (OFF); always off since last STATUS 


CARRIER DETECT (CRX) 

12 Carrier now (ON); on 

8 Carrier now (ON): not 

4 No carrier now (OFF); 

0 No carrier now (OFF): 


since previous STATUS 
always on since last STATUS 
not always off since last STATUS 
always off since last STATUS 


DATA RECEIVE (RCV) * 

1 MARK (1) now 

0 SPACE (0) now 

-» No Information is supplied about the past status of RCU. 
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APPENDIX 5 


SETTING THE BAUD, NORD SIZE, STOP BITS, AND READY MONITORING 

The CDNFIGURE BAUD RATE c OMand ailotus you to se t the Baud rate, 
"word“ sire. number of stop bits to transmit, and enable or disable 
checking of DER, CTS and CRX. The command may be issued through an 
open channel to the RS-232-C port, or may be issued through a channel 
uhich isn't being u s e d. If uou have opened a channel to the port you 
are configuring, you must use that channel You cannot configure any 
port if a concurrent mode I/O Operation is active. 

The CONFIGURE BAUD RATE command looks like this in BASIC: 



XIO 36, #channel, Auxl, Aux2, “Rn: " 


I 

i 

I- 

I 


The 36 makes this a CONFIGURE BAUD RATE command. 

Channel is the number of the cnannel that BASIC should use to execute 
the c omman d. The channel should either be open to the port you are 
configuring, or should not be open at all. No concurrent mode I/O 
should be active uh e n you issue this command. 

Auxl is a number or expression that specifies the Baud rate, "utord 11 
size, and number of stop bits to send with each “uord. 11 For each of 
these, pick a number from tables I, II, and III, and then add the 
numbers together to form Auxl. You may add them together yourself or 
you can let BASIC add them for you. For exampie; XIO 36, #1, 128+0+10, 

0, “R: “ and XIQ 36, 138, 0, "R: 11 both specify the same thing. 

Aux2 is a number or expression that specifies uhether or not the 
Interface Module should check Data Set Ready <DSR), Clear to Send 
(CTS), and/or Carrier Detect (CRX) uhen a block mode output or START 
CONCURRENT MODE I/O Operation is performed. If you ask to have the 
Interface Module check one or more of these, then the Interface Module 
ui 11 returr, error statu» if the line(s) checked is not ON. You may 
TRAP the error and program BASIC to take the action you desire. See 
table IV for values of Aux2. 

The last XIO parameter, “Rn:", specifies uhich serial port of the 
Interface Module you are configuring. For n put 1, 2, 3, or 4, just 

as you uould in the OPEN command. 

■Ctext continues after tables. . . > 


J 
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TABLE I: BAUD RATE SPECIFIERS TO ADD TG AUX1 


ADD BAUD RATE 


0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

10 
1 1 
12 

13 

14 

15 


300 bps (bits per second) 
45. 5 bps# 

50 bps# 

56. 875 b p s * 

75 bps## 

110 bps 
134. 5 bps### 

150 b p s 
300 bps 
600 bps 
1200 bps 
1800 bps 
2400 bps 
4800 bps 
9600 bps 
9600 bps 


* These Baud rat es are usefu1 for communications with Baudot 
teletypes, for RTTY (radioteletype) applications. They 
are tnore c ommon 1 y referred to as 60, 67j and 75 war d s per fninute, 
## This Baud rate is sometimes used for ASCII Communications, 
and may also be used for 5-bit Baudot RTTY. The latter is 
commonly referred to as 100 wpm. 

#*# This Baud rate is used by IBM Systems. 





TAELE II: WORD SIZE SPECIFIERS TO ADD TO AUX1 
ADD WORD SIZE 


0 

3 

b i ts 

16 

7 

b i ts 

32 

6 

b i ts 

48 

5 

b i ts 


See text for discussiön of uord sizes. 


TAELE III: SPECIFIER FOR 2 STOP BITS TO ADD TO AUX1 

ADD STOP BITS.SEND WITH EACH WORD 

0 1 

12B 2 

TAELE IV: AUX3 SPECIFICATIOM TO MONITOR DSR, CTS, CRX 


ADD 

TO MONITOR 


G 

None 



1 



CRX 

2 


CTS 


3 


CTS, 

CRX 

4 

DSR 



5 

D3R, 


CRX 

6 

DSR, 

CTS 


7 

DSR, 

CTS, 

CRX 





■{...continuation of t e x t > 

Note that the d e f au 11 (pre-set) va1ues of Au x 1 and Au x2 for all f our r 

ports are lero, c orresp ond ing to 300 Baud, B-bit words, one stop bit 
transmitted, and no checking of DSR, CTS or CRX. 

You should kn duj the following things about this c ommand: 

The configured paranieters u/ill stay as you set them until you either 
reset them or until you rebaot the System (turn the power off and back 
on). The SYSTEM RESET key will NOT reset any of these Parameters. 

You may configure each RS-232-C port independently. 

If you specify 8-bit words, there are no restrictions on operationn of 
the port. Howe v er j the following restrictions apply to 7-, 6-, and 

5~bit words: half-duplex Operation only; some limitations on baud 

rates. Specificallyr all output baud rates are allowed in Block 
Output mode. In Concurrent Made, either in or out, you are limited to 
Operation at 300 Baud and below, If you specify 7-, 6-, or 5-bit 

words. there is no restriction on the number of stop bits you may 
specify. Note that mast applications of these Word siies will 
probably be to devices that require mors than 1 stop bit — you should 
sp ec i fy two. 

If you specify 7—, 6-, or 5-bit words. each wort) sent or recived will 

be converted fron or to an 8-bit byte within the Computer by ignoring 
the most significant bitis). This will very likely interact with the 
translation Operation, and in particular there may be no way you can 
receive an EOL. If this is the case, you cannot use the BASIC INPUT 
statement to read the port and you must retrieve characters one at a 
time using GET. More details will be found in the section on 
translation modes. (APPENDIX 6) 

If you specify that you want the Interface Module to check D5R, CTS 
and/or CRX, it will check them whenever you try to start concurrent 
mode I/O and whenever you try to send a block of data in block output 
mode. If any of the lines you asked to be checked is not ready (OFF), 
then the concurrent mode I/O will not be started or the block of data 
will not be sent. The Interface Module will then return an error to 
BASIC, and you may TRAP the error and take corrective action. 

Following the TRAP, you may perform a STATUS request from the 
Interface Module to find out what the problem was. 

Note that CTX and CRX are not supported on ports 2, 3, and 4, and that 
DSR is not on port 4. The Interface Module behaves as if they were 
really there, however, and acts as if they were always ready <ON). 

You may look at the states of DSR, CTS and CRX at any time that 
concurrent mode I/O is not active (if you have a channel open to the 
port) by issuing a ST ATUS request for the port, Thus, ena b ling this 
automatic checking of these lines is not the only Option available to 
you, and you may prefer checking them directly with STATUS. 
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APPENDIX 6 


TRANSLATION AND PAR ITY HANDLING 

The Interface Moduls Händler can fas configured to perform certain 
types of code conversicns (tranilations) and do parity generating and 
checking for you. These tma operations interact with each other. Por 
this reason, they will b e described togethsr in this section. The 
yarious options you may select for each are even specified by 
executing the same comtnand—CONFIGURE TRANSLATION AND PARITY, 

There are three factors you need to keep in mind when you are setting 
up your Code translatigns. Translation) of coursei is one of them, 
since it results in (possibly) changing one code into another. Parity 
generation and checking also may result in changing one code into 
another. The third factor you need to keep in mind is the the word 
size you are tränsmitting/receiving. Inside the Computer, all uords 

are the same as bytes; that is. all words are 8 bits. If you are 
send ing/rec e i v iny 7-, 6-, or 5~bit words, these shorter words have to 

come from S-bit Computer words by chopping out some bits; or expanded 
into 8-bit Computer words by adding some bits. These operations 
obviously are the same as changing one code into another. 

Each of these three possible code changes takes place separately from 
the othersi one at a time. For output, translation comes first, 
fallowed by parity generation. and finally truncation Cshortening by 
leaving bits off). Of course. at each stage a change may not occur. 
depending on what selection of options you have configured and 
depending on which character (code) the Computer is sending. For 
examplei if you have configured 8-bit words, the trunction Operation 
does nothing. For input-, the Order of code changing is Expansion (from 
short words to B—bit words), followed by parity checking. and finally 
tr ans la t i on, 

At each of the three stages. a code change may occur, If a change 
DOES occur, then it is the CHANGED Code which will be operated on in 
the next stage. For example, (in a particular configuration of 
translation and parity options) if you output an ATASCII EOL, it mou1d 
first be translated to an ASCII CR and then parity would be generated 
for the CR. This is because the parity step operates on the result of 
the translation step. in this case the CR. 

There is one other translation Option which is very specific, namely, 
the Option to have an ASC II LF (line feed) sent after each transmitted 
CR (Carriage Return). This code change occurs at the translation 
step. Consequently, the generated LF will go through the parity and 
truncation (sma11 uord) phases just like the CR. 


TYRES QF CODE TRANSLATION 

You have three options to choose from: no translation at all, "light" 

translation. or "heavy" translation. Whichever Option you choose will 
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apply both to incoming and outgoing characters. The "no translation" 
Option is just what it says--no change is made to the characters, 
whether being received or sent. This statement applies only to the 
translation step, of course—you tan still get changes froo parity and 
small words, The no-translate Option is useful if you are going to do 
yout own special processing on the characters you are sending and 
receiving. This can be particularly useful in the sma1l~word 
situations; since many o f the cases wh er e small words are used do not 
(or cannot) involve ASCII. You tnay also want to use the 
no-translation Option if the RS-232-C-compatible device you are 
communicating with understands ATASCII. 

No matter which translation Option you choose; if you use a BASIC 
INPUT statement to read data the data must have an ATASCII EOL (End of 
Line) character at the end of each line. This requirement applies 
AFTER all translation. Thus, if you select the no-trans1ation optioni 
your incoming data must either contain EOL 's or you should use GET 
instead of INPUT. Remember, also, that using short words and that 
checking parity also affect data coming in, so you may still need to 
use GET. 

Heavy and light translation are two ways to convert between ASCII and 
ATASCII. In either translation mode, the ATASCII EOL (9B in 
hexadecimal, 155 in decimal) is converted to and from the ASCII CR (OD 
in hex, 13 in decimal). In the case of output, EGL is changed to CR; 
if you also selected the Append LF Option, EOL is changed to CR 
followed by LF, that is, the translation function produces two 
characters out for one in. On input, a CR will be translated to EOL. 
Both Heavy and Light translation modes assume ASCII in the outside 
world and they assume ATASCII in the Computer. ASCII is treated as a 
7-bit code; that is, the Sth (most significant) bit is always treated 
as if it is zero. On input, then, if you select Heavy or Light 
translation, the Sth bit of each word is cleared to zero. On output, 
the translation step will set this bit to zero. 

Light translation performs the fewest changes between ASCII and 
ATASCII. The assumption is that you wish to war k with ATASCII within 
the Computer but treat it as if it were really ASCII. Note, for 
example, that the ATASCII graphics codes are the same (numerica 11y, 
and for the most part the way you type them, too) as the ASCII c ontro1 
codes (1-26). So for input, the character has its high bit stripped 
(set to zero), and that's all—except if the code is found to be a CR, 
it is changed to an EOL. For output, if the character being sent is 
EOL it is changed to CR; then, no matter what the character is, the 
high bit is set to zero. Light translation is the pre-set default 
mode. 

Heavy translation is a more thorough translation mode. Here the 
assumption is that if there is no direct correspondence between the 
character in ASCII and ATASCII, then the code should not be 
translated. So for input, after the high bit is cleared to zero, if 
the character is CR it is changed to EOL; otherwise, the character is 
checked to see if it is the same in ATASCII as in ASCH. If it is 
not, it is translated to the WON'T TRANSLATE character. Specifically, 


50 


if the Code for the ASCII character is lass than 32 decimal (i.e.. the 
character is a r 0 ntrol character) or greater than 124 decimal (7C hex) 
it will be trans1a t e d to the M tuon , t translate character, Thus, 
heavily translated ASCII corresponds to the printable characters frora 
blank through verticai bar. The "wan't translate 11 character is 
specified by you in the CÜNFIGURE TRANSLATION command. IT you do not 
specify it. the pre-set default value for it is zero (ATASCII graphic 
h eart). 

On ootput, heavy translation converts EOL to CR, and ujill output any 
character wh o s e ASCII meaning is the same as it is in ATASCII. That 
is, characters whose values ränge from 0-31 decimal (ASCII control 
va 1 u e s) or whose values are above 124 decimal (7C hex) utill not be 
sent. Note that characters whose high bit is one will be translated 
to nothing, that is, characters which uiould shou on the TV screen as 
INVERSE VIDEO WILL NOT BE SENT in heavy translation mode. Note also 
the difference between input and output in the heavy trans- lation 
mode: untranslatab1e characters in the input are converted to the 

"won't translate" value, where untranslatab1e output simply is not 
sent out. 

The (optional) sending of LF after CR is produced in the translation 
step. If you specify no translation, the Option of adding LF to CR is 
not available. If you specify light translation, LF will follow EOL 
(which of course becomes CR). Note that sending the 13 decimal code 
(CR) by itself EOL will be turned into a CR/LF pair (with the append 
LF feature turned on). Each character in the CR/LF pair is 
independent 1y sent through the parity and word-shortening steps on its 
way out. The pre-set default setting of the append LF feature is OFF, 
that is, the default is to NOT append the LF. 


PARITY 


You may select input and output parity handling separately. Thus, you 
may choose to send, for example, even parity while you ignore the 
parity of what you are receiving. The parity is always themost 
significant bit of each B-bit byte (bit number 7>, Thus, this parity 
Operation is not applicable if you are working with 7-, 6-, or 5-bit 

words. 

In the default parity condition, the parity bit of neither input nor 
output is altered. Note, however, that the parity bit of out— going 
messages may have been changed during the translation step. 

For output, you may select even parity, odd parity, set parity bit or 
no parity. 

For input, your choices are "don't touch", check even, check odd, and 
"don't check". Each of these last three options will clear the top 
bit to zero, whether or not a parity check is made. If an input parity 
error is found, the character will still be input as if it were all 
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righti the parity error f lag will be turned on in the status b y tes 
Csee STATUS REQUEST). 


SHORT-WORD CONVERSION 

The third Operation which affects your Code translation is the 
short-word conversion Cif you are using 8-bit words, this is a 
11 no-effect" Operation). Short words sent out are made from S-bit 
Computer characters by omitting the most significant bits. That is< a 
7-bit word is bits 0-6 Df the character, a 6-bit word is bits 0-5. and 
a five-bit word is bits 0-4. Thus the parity. if generated, is lost, 
ASCII is a 7-bit code; you can send ASCII in 7-bit form without parity 
Cthis is not common practice, though—usually 8 bits are sent even if 
the 8th bit is not used for parity). With 6-bit and 5-bit codes. you 
will not be using ASCII, so you will have to concern yourself with the 
codes you want to be sending. Witb these word sizes, you should turn 
translation off so the translation performed by the Interface Module 
handler will not affect the Codes you are working with. 

On input. small words are converted to 8-bit Computer characters by 
adding high-order bits, These added bits are always set to 1. Thus. 
if you are receiving 7-bit ASCII, the parity and translation steps 
will be getting ASCII with the 8th bit set high. If you are receiving 
6 - or 5-bit codes. there is no woy you can receive the 13 decimal (OD 
hex) code (ASCII CR)-—after all. you cannot receive ASCII in 6 or 5 
bits anyway. This means that in BASIC you will have to use the GET 
statement. nöt INPUT. Of course. you will be doing your own code 
conversion. so you should turn off the conversions of the Interface 
Module hand1er. 

The CONFIGURE TRANSLATION MODE command is specified in BASIC this way: 



XIO 38, ichannel, Auxl, Aux2, "Rn:“ 


1 

H 

■ 

i 


38 specifies the CONFIGURE TRANSLATION MODE command. 

fcChannel specifies the channel numoer <IOCB number from 1 to 7) you 
wish to use to configure the translation mode. You may use an unopen 
channel if you have no channel open to the port you are configuring; 
otherwise you must use the channel you have opened to that port. You 
cannot issue the CONFIGURE TRANSLATION MODE command if any concurrent 
mode I/O is active. 

Auxl specifies the translation mode, the input parity mode, the output 
parity mode, and the Append LF Option. You specify these Options by 
adding numbers taken from tables I, II, III and IV. You may add the 
numbers yourself and put the sum in your program for Auxl, or you may 
let BASIC add them for you (e, g. , you can say either 2+8+32 or 42 to 
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tnean even parity in, even parity out, and no - trans la t i on >. Do not add 
in more than one value from each table. 

Aux2 i-s the numeric represeirtation of the "won't translate" character 
for heavy translation. Remember that the BASIC function ASC will give 
uou the numeric representation of a character. For example, 41 and 
ASC<"A") mean the same number. The number you specify should be from 
0 through 255. 

"Rn;" specifies the port you are configuring. For n, you put 1, 2, 3, 

or 4. You may omit n, which will mean you are configuring port 1. 

The default configuration is Auxl=0 and Aux2-0. If you execute the 
CONFIGURE TRANSLATION MODE command for one of the RS-232-C ports, that 
configuration will remain in effect until you do another CONFIGURE 
TRANSLATION MODE for that port. SYSTEM RESET will not change the 
translation mode for any port. Of course, you can configure each port 
a d i fferent way. 



TASLE I—TRANSLATION MÜDE OPTIONS ADDED TO AUX1 


Add 


To Get 


0 

16 

32 


Light ATASCII/ASCII translation 
Heavy ATASCXI/ASCII translation 
No translation 


TABLE II—INPUT PARITY MODE OPTIONS ADDED TO AUX1 
Add To get 


0 

4 

5 

12 


Ignore and do not change parity bit 
Check for odd parity* clear parity bit 
Check Por even parity* clear parity bit 
Do not check parity b u t clear parity bit 


TABLE III—OUTPUT PARITY MODE OPTIONS ADDED TO AUX1 


Add 


To get 


0 

1 

2 

3 


Do not change parity bit 
Set output parity odd 
Set output parity even 
Set parity bit to 1 


TABLE IV—APPEND LINE FEED OPTIONS ADDED TO AUX1 


Add 


To get 


0 

64 


Do not append LF 

Ap p end LF after CR (translated f rom EOL) 
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APPENDIX 7 


CONTROLLING THE OUTGOING LINES—DTR, RTS & XMT 


There are up to three outgoing RS-232-C Signals on each of the RS232 
ports of the Interface Module: Data Terminal Ready (DTR), Request to 
Send (RTS), and Data Transmit (XMT). Each of these lines can be 
turned ON or OFF with the CONTROL tommand. 

Port 1 supports all three Outputs. Ports 2 and 3 have DTR and XMT; 
port 4 has only XMT, You may use this command the same way with any 
P ort—it is not an error to try to control a line that does not exist. 
Your attempt ujill simply have no effect, 

You may control any or all of these lines on a single RS-232-C 
port tuith the CONTROL command (controlling lines on other ports 
requires one CONTROL command for each port). The CONTROL command may 
be issued to a port which is not OPEN through an I/O channel by 
specifying any unopen channel number in the CONTROL command. If the 
port has been opened through a channel, you must use that channel in 
the CONTROL command. You may not issue a CONTROL command if any 
concurrent mode I/O is active, 

Controlling XMT line has very limited use and feuj users will be 
concerned with it. In its normal state XMT is passive. If you change 
XMT you are likely to interfere with the normal transmission of data. 
In the serial communication morld the only practical use of control of 
the XMT line is to send a BREAK Signal. The BREAK is simply a period 
of holding the XMT line out of its normal resting state. Specifically, 
the normal resting state is called MARK, which conresponds to the 
binary "1" state. A BREAK is a period of the state called SPACE, 
which corresponds to binary "0". (Actually, since MARK and SPACE are 
the only legal states of any RS—232—C Signal, all data consists of 
alternating MARKS and SPACES. What distinguishes BREAK from other 
uses of SPACE is that a BREAK is a SPACE which is a lot longer in 
duration than the time that a transmitted word would be. This is so 
because any transmitted word ALWAYS has one or more MARK bits in 
it in particular, each word ends with one or more stop bits 
represented by MARK. ) Thus to send a BREAK, first issue a CONTROL 
command to set the XMT line to SAPCE (0), then a little while later 
issue a control to set it back to MARK (1). 

The uses of the other lines will depend on your application. For some 
guidelines, see APPENDIX 1. 

The pre-set default state of the DTR and RTS lines is OFF. The pre-set 
default state of the XMT line is MARK. Once you change any of them 
with the CONTROL command, the new setting will remain until you either 
turn the Computer off or issue another CONTROL command to change 
things. The SYSTEM RESET key has no effect on these lines. 
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The form of the CONTROL command in BASIC is: 


E 

■ 

■ 

i 


XIO 34, Öchannel. Auxl, Aux2, "Rn:" 


: 

i 

j 


34 specifies the CONTROL command. 

#channel specifies the IOCB or channel number (1-7) you iitish to use 
for the command. If no channel is open to the RS-232-C port, specify 
an unused channel. If the port is 'open through a channel. use that 
channel. 

Auxl is the sum of three numbers chosen from tables I. II. and III to 
control DTR. RTS. and XMT. Choose only one number from each table. 

You mag add the numbers together ycurself and put the resulting sum in 
tjour program for Auxl, or you may put an expression for the sum and 
let BASIC do the arithmetic for you. 

Aux2 is not used by this command; the best value to specify is zero. 

"Rn:“ specifies the RS-232-C port you are acting on. For n you put 1. 
2, 3, or 4. If you omit n, the Interface Nodule handler will assume 
you mean port 1. 







APPENDIX 8 


STARTING CGNCURRENT I/O MODE 

Use the command START CGNCURRENT I/O (XIO 4Q> to start concurrent I/O 
mode. This mode may be used for output and must be used for input or 
full duplex. The port must be open before you can start concurrent 
I/O. Once concurrent I/O is in effect no other I/O operations which 
use the Computer I/O connector can be performed. I/O Operation to 
another serial port, for example, can not be performed. I/O to the 
keyboard, the screen, the Editor and the Controller jacks can still be 
performed, 

The concurrent mode I/O Operation may be terminated by SYSTEM RESET, 
BREAK; or by closing the port. 

Operations which are a11owed wh i 1 e concurrent mode I/O is active are 
input and output operations to the active port (GET; INPUT; PUT; 

PRINT); and STATUS commands to that port. 

There are two different forms of the START CONCURRENT MODE I/O 
command. The main difference between them is that one specifies the 
use of a small input buffer built into the Interface Module handler 
(in the Computer); and the other alloms you to give your own buffer to 
the handler so it can be any size you wish, (NOTE: in Assembly 
Language these two options are really just different forms of the same 
command. ) 

The form of the START CONCURRENT MODE I/O command which a11ows you to 
specify your own I/O buffer has two d i sad van tag es: the command is 

complicated to specify in this form; and the BASIC array you use as 
the buffer may be moved by the BASIC Interpreter. Once created; BASIC 
arrays are NOT moved while a program is being rum but arrays are 
moved whenever you add or delete a BASIC statement; even in immediate 
mode. The handler for the Interface Module is told of the location of 
the buffer only when you start the comcurrent I/O; thus, if you allow 
BASIC to move the array, data will be inserted in unpredictab1e 
locations, possibly destroying even the BASIC program itself. Ongoing 
concurrent input could wind up in other arrays or variables; or even 
in your BASIC program! SO REMEMBER: IF A PROGRAM IS USING CGNCURRENT 

MODE INPUT, ALWAYS MAKE SURE THE CGNCURRENT MODE OPERATION IS STOPPED 
WHEN YOUR PROGRAM STOPS. This will be done for you if you stop by 
using BREAK key, SYSTEM RESET key, or end your program with END or 
letting the program stop by "running off the end." 

STOP does not terminate the concurrent inputi and neither will it be 
stopped if an ERROR happens. IN THESE CASES, THE WAV TO STOP THE 
CONCURRENT I/O IS TO PRESS THE BREAK KEY. 

None of these problems occur if you use the buffer which is built into 
the Interface Module handler; since that buffer does not move! ön the 
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other hand, that buffer is qu i te sma11 (32 b y tes) and this may not be 
adequate for all programs. 

Wifch a small input buffer you need to GET or INPUT the data from the * 

buffer before the buffer fills up with data that you have not yet 
read, Df coursei if in the long-range average you read the data out 
of the buffer more slowly than it is arriving, you will eventually 
lose data anyway. If this is the casei you will either have to put up 
with losing it (which is not all that bad in some cases), or you will 
have to figure out a way to slow down the device that is sending the 
data to you (such as setting a lower Baud rate), Even if your program 
processes the data fast enough in the long runi a small buffer puts 
demands on your progratn to get data quickly and often. Here are some 
things to consider. 

The BASIC Interpreter is quite slow relative to incoming data; if you 
want to do some Processing on each and every character that comes in. 

In that case, 300 Baud would be fast. On the other hand, the System 
is more than fast enough to read in a line of data (terminated by CR) 
at 9600 Baud (960 cps)—as long as there is enough time between lines 
for your program to do its processing. It pays to read a whole line 
of input at a time (use INPUT wherever possible instead of GET), and 
it's really helpful if the inputting device will pause for you after 
each line. Even if the inputting device will not pause, reading a 
line at a time may buy you the processing time you need. The best 
thing to do is try it. 

NOTE: In order to perform 1ine—or i ented input using the BASIC INPUT 

statement, the input must either have an ATASCII EOL at the end 
of each input line, or must have an ASCII CR terminate each 
line. In the latter case, you must configure the translation 
mode of the Interface Module port to convert the CR into EOL. 

This is discussed more fully in the section on configuring 
translation mode. 

A large input buffer will be needed if you can read the data from the 
buffer only in large, occasional bursts. For example, if you do not 
know how long it will take to process a line of input because some 
lines require a lot of work, you will want to allow lines to "back up" 
in the input buffer. This will work fine as long as you do not get 
too many of these "slow" lines at once. You will probably have to 
determine the needed size of your input buffer by trial. 

The numher of characters that can come in every second depends on the 
Baud rate—the higher the Baud rate the faster characters can arrive. 

Thirty characters may arrive each second at 300 Baud, 400 may arrive 
in the same time at 4800 Baud. Of course, if the sending device does 
not run at the maximum possible speed— if there are "gaps" between 
characters anywhere — then the speed of characters will not be ???. 

Thus the Baud rate can control the MAXIMUM data transfer rate, but the 
actual or EFFECTIVE data transfer rate may be smaller. 

What things boil down to is that your program in BASIC must INPUT data 
from the input buffer faster than the Interface Module puts them there 
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from your RS-232-C compatible device; that is, your BASIC program must 
read the data fester than your device 's effective data transmi ss i on 
rate (on average K You c a n control that rate b y setting the Baud 
rate- and possibly there are other uays to control the transfer rate 
(that depends on the device itself). Be prepared to experiment to 
■find the beet mode of Operation. 

In BASIC- the START CONCURRENT MODE I/O Operation tuhich uses the 
built-in in put buffer looks 1 i k e this: 


I 

! XIÜ 40. #c hanne 1. 0, 0- "Rn:" 

l 


I 


Specify the appropriate open channel. and specify 1. 2- 3- or 4 for n 

in "Rn: If you leave n out (i. e. - "R: ")- then port 1 is assumed. 

You MUST specify zero for both Auxl and Auxl. since this is the iitay 
you teil the RS-232-C handler to use its outn input buffer. 

If you opened the port for output only- then only concurrent output is 
enabled. If the port is open for input only. then only concurrent 
input is started. If the port uas opened for both. then concurrent 
mode input and output are started (full duplex). See the section about 
the input and output commands for details on how these various modes 
op erate. 

In BASIC- the START CONCURRENT MODE I/O Operation in which you suppig 
the input buffer for the handler is specified by a series of POKEs 
followed by calling the Central I/O (CIO) through a USR function. The 
POKEs specify the type of Operation- and specify the buffer address 
and length. You PÜKE these values into the I/O Control Block (I0CB) 
corresponding to the channel you have opened for the RS-232-C port. 
Here is an example program: 

10 DIM BUFt(500), RSTART$(7) 

20 LET R5TART$ = "hhh^LUd'’ NOTE: a bar over a 

character here means 
inverse video.> 

30 LET FILE = 2 

40 OPEN ftFILE, 13. 0, "R4:" 

50 LET IÖCB = 16*FILE 
60 LET BUF = ADR(BUF$) 

65 LET BUFLEN = 500 

70 LET RSTART = ADR(RSTARTi) 

80 POKE 832+1OCB+2. 40 
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90 POKE 832+IÜCB+4, BUF-(INT(BUF/256)*256) 

100 POKE B32+I0CB+5, INT(BUF/256) 

110 POKE S32+I0CB+8, BUFLEN-(INTCBUFLEN/256)#256) 
120 POKE 832+I0CB+9, INT(BUFLEN/256) 

125 POKE 832+I0CB+10i 13 

130 DUMMY = USR(RSTART. IOCB) 

140 STARTSTATUS = PEEK(832+I0CB+3) 


In this programi a full duplex f i 1 e i s opened through channel 2 to 
RS-232-C port number 4 (the 13 in line 40 specifies full duplex). 

Lines 50 through 70 set up sotne values tuhich are used by the START 
CONCURRENT MODE I/O Operation. The buffer is setup in lines 80 
through 130. Line 140 gets the Status value returned by the I/O call. 
Each POKE statement puts some needed value into the I/O Control Block 
(IOCB). The address to poke is specified as the sum of the follouiing: 
the first address of the IOCB's (832). a value specifying (uhich IOCBi 
and an "offset" into the IOCB for the particular value you are 
POKEing. The value specifying the IOCB is 16 times the channel number 
through (uhich you have opened the RS-232-C port (in this case tue set 
the variable IOCB to 32 in line 50. since the channel is 2). 

The values poked into the IOCB are: 40 into offset 2i the buffer 
location (address) into locations 4 and 5; the buffer length into 
offsets B and 9; and 13 into offset 10. Pay special attention to the 
fact that the buffer address and the buffer length are both 2-byte 
values. requiring two POKEs to put them into the IOCB. Those 
complex-looking expressions in lines 90 through 120 are simply 
Splitting the address and length into their lotu-part and high-part so 
each part can be POKEd individua11y. 

Line 130 calls the I/O System through a USR function. This USR 
function has two arguments: the address of the function. and the IOCB 
specifier (the same as was used in specifying the POKE locations). The 
address of this USR function was found in line 70. so you see that the 
function is the character array called RSTART*. The function itself 
is the odd-looking sequence of characters in line 20. Be sure to type 
this character sequence carefully suhen before you call this USR 
function—any mistakes and your program luill probably produce an 
unrecoverable failure. 

Assemb1er note: This USR function is the following in Assemb ly 
Language: PLA; PLA; PLA; TAX; UMP *E456. The first four instructions 
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get the IQCB number into the X- register. and the return address is on 
the stack, so the I/O System is "called" by jumping to it!> 

Line 140 gets the I/O status after the USR I/O call. You do not need 
to get the status if you do not want to. To g e t status PEEK at offset 
3 in the IOC33. The status tui 11 be 1 if all went well, Qther— wise. 
the status is the same as the error number that BASIC prints after an 
I/O call fails. (Note that the variable DUMMY in the program abave 
does not get any meaningful value. ; 

Once this START CONCURRENT MODE I/O Operation has been performed. the 
concurrent I/O is active. The Operation mag be either in-only. or it 
rray be full-duplex (as specified in the OPEN), If you are running 
full-duplex, the output buffer is built into the Interface Module 
handle t-, The input and output buffers are accessed through norma 1 
input and output Statements in BASIC; see the section on input and 
output statements. Once again, take note; BASIC MAY MOVE ARRAYS 
AROUND IF YOUR PROGRAM STOPS, IF THE CONCURRENT MODE INPUT CONTINUES 
AFTER YOUR PROGRAM STOPS, THIS MAY RESULT IN QUERWRITING SQMETHING 
OUTSIDE YOUR BUFFER ARRAY. IF YOU ARE NOT SURE WHETHER OR NOT THE 
CONCURRENT I/O HAS STOPPED, PRESS THE BREAK KEY TO STOP IT. 

NOTE: there is a 256 byte area at address 1536 (decimal) mhich you 

may use as an input buffer or anytning eise. Be sure that area 
is on 1 y being used for the one thing you wi sh. No ATARI 
Software uses this area except just after you turn the machine 
on. but you should be careful of non - ATARI Software you use 
with BASIC. 1536 splits nicely into low - and high - parts (so 
does 256), so you could replace lines 90 through 120 of the 
above program: 

90 POKE 832+I0CB+4, 0 
100 POKE B32+IÜCB+5. 6 
110 POKE 932+I0CS+8. 0 
120 POKE 832+1OC3+9. 1 

If you use this area. you do not need to worry about it when your 
program stops since BASIC will not move it. 
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